home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 25 / arcf104.zip / ARCF.DOC < prev   
Text File  |  1987-10-23  |  4KB  |  145 lines
  1. ARCF  Find Text in ARC Files.               Version 1.04  Oct 23, 1987
  2.  
  3.  
  4.  
  5.  
  6. Purpose:  To search files in ARC archive files for text strings.
  7.  
  8.  
  9. Format:   ARCF    [d:][path]filename[.ARC]  [filespecs...]  "text"
  10.         [/B] [/C] [/F] [/Q] [/S] [/W]
  11.  
  12.  
  13. Usage:      The d:path\filename and "text" parameters are required.
  14.       The drive and path are optional. The 'filename' and
  15.       'filespec' parameters may contain the wildcard characters *
  16.       and ?.  All files matching the 'filespec' specification
  17.       within the 'filename' are processed.
  18.  
  19.       If the 'filename' extension is omitted, the extension .ARC
  20.       is used.
  21.  
  22.       The 'text' search criteria must begin and end with a
  23.       double quote character, e.g. ARCF TEST.ARC "SOMETHING".
  24. |      You may include the ? character in the search text to
  25. |      denote "any" character. Thus, "A?C" would produce a match
  26. |      if "ABC" or "A2C" occurs in the files processed.
  27.  
  28.       The optional switch (/x) characters must be the last
  29.       operands, e.g. ARCF TEST "april 1" /c/w.
  30.  
  31.       Normally, you would only want to search "text" files for
  32.       strings.  Text files consist of ASCII record.  Each
  33.       record ends in a carriage control (CR) character.  The
  34.       maximum record length is 4096 bytes.    To search all
  35.       files, binary and text, use the /B option.  A maximum of
  36.       80 characters is display when text is found in a record.
  37. |      All control characters are changed to spaces.  If /B is
  38. |      used, any hi-ASCII (greater than 127) characters are
  39. |      blanked out.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.       ARCF (c) Copyright 1987 by Vernon D. Buerg. ALL RIGHTS RESERVED.
  58.  
  59.  
  60.  
  61. ARCF  Find Text in ARC Files.               Version 1.04  Oct 23, 1987
  62.  
  63.  
  64.             Option Switches
  65.             ---------------
  66.  
  67.     /B - include Binary files, i.e. files with the extensions
  68. |         of .EXE, .COM, .OBJ, .LIB and .BIN.
  69.          If omitted, only non-binary files are searched.
  70.  
  71.     /C - case sensitive search; if omitted, the search for the
  72.          text is made regardless of the case, i.e. upper case
  73.          and lower case letters are treated the same.
  74.  
  75.     /F - display the name of the file begin searched only if
  76.          the scan text is found within the file; if omitted,
  77.          the names of all files are displayed as they are
  78.          proccesed.
  79.  
  80.     /G - supplies any encryption (garble) password, e.g.
  81.          /GPSWD would supply PSWD as the password.
  82.  
  83.     /Q - suppress beeps and bells; if omitted, beeps are sent
  84.          with error messages.
  85.  
  86.     /S - suppress displaying the names of the files being
  87.          processed; this includes suppressing the display
  88.          of the archive file name(s), too. When used with
  89.          /F, the only display is of the file name that
  90.          contains the search text.
  91.  
  92.     /W - ignore white-space; if omitted, spaces and tabs are
  93.          significant.
  94.  
  95.  
  96.  
  97.  
  98. ARCF  Find Text in ARC Files.               Version 1.04  Oct 23, 1987
  99.  
  100.  
  101.             Version history
  102.             ---------------
  103.  
  104.     1.00 - 10/8/87 - First public release.
  105.     1.03 - 10/16/87
  106.       - Improve display when control characters are involved
  107.       - Allow use of ? as wildcard in search text
  108.     1.04 - 10/23/86 - Add more binary extensions.
  109.  
  110.  
  111.             Restrictions
  112.             ------------
  113.  
  114.     Written for the IBM PC using DOS 2.0, or later,
  115.  
  116.     ARCF is free, but it is a copyrighted work and may be distributed only
  117.     pursuant to this license.
  118.  
  119.     Permission is hereby granted to reproduce and disseminate ARCF so long
  120.     as:
  121.  
  122.        (1)    No remuneration of any kind is received in exchange; and
  123.  
  124.        (2)    Distribution is without ANY modification to the contents of
  125.         ARCF.COM and all accompanying documentation and/or support
  126.         files, including the copyright notice and this license.
  127.  
  128.     No copy of ARCF may be distributed without including a copy of this
  129.     license.
  130.  
  131.     Any other use is prohibited without express, written permission in
  132.     advance.
  133.  
  134.  
  135.  
  136.             Vernon D. Buerg
  137.             456 Lakeshire Drive
  138.             Daly City, CA  94015
  139.  
  140.             CompuServe: 70007,1212
  141.             Data/BBS:   415-994-2944
  142.  
  143.  
  144.  
  145.